默认变量

“系统变量 - 默认”协议允许创建可指向以下相关 HMI 系统变量的标签:

 

协议编辑器设置

从“协议编辑器”对话框的“PLC 模式”列表中,选择“默认”。

 

标签编辑器设置

路径:项目视图 > 配置 > 双击标签

  1. 要添加标签,请单击 +:系统将添加新的一行。
  2. 驱动程序列表中选择系统变量:“标签定义”对话框将显示。

元素 说明

内存类型

表示标签所引用的系统变量。 

以下部分显示按类别分组的可用系统变量的完整列表。

报警变量
变量名称 说明 数据类型
Alarm not acknowledged

未确定报警时为真

(未启动未确定<>0) 或 (未确定启动<>0)

boolean

只读

Alarm triggered

启动至少一个报警时为真

(确认启动<>0) 或(已启动 <>0) 或 (未确认启动<>0)

boolean

只读

Number of missed alarm events 报警超过事件队列在 engineconfig.xml 文件中已定义队列长度。

int

只读

Number of not triggered acknowledged 报警条件不再运行;报警已确认

int

只读

Number of not triggered not acknowledged 报警条件不再运行;等待确认

int

只读

Number of triggered acknowledged 报警条件在运行状态;报警已确认

int

只读

Number of triggered alarms 报警处于运行状态:不需要确认

int

只读

Number of triggered not acknowledged 报警条件运行;等待确认

int

只读

响铃变量
变量名称 说明 数据类型
Buzzer Setup

0 = 已禁用

1 = 已启用(在出现任何触摸屏幕事件时,蜂鸣器发出声音)

2 = 蜂鸣器状态由蜂鸣器控制系统变量或由主手册中“项目属性”内的触摸响铃属性控制

 

触摸屏幕响铃(设置 = 1)在 Linux 平台上不可用。请参阅可作为替代的“触摸响铃”属性。

int

Buzzer Control

0 = 蜂鸣器关闭

1 = 蜂鸣器打开

2 = 蜂鸣器闪烁

int

Buzzer Off Time 当选择闪烁时,以毫秒表示关闭的持续时间。默认 = 1000。范围:100-5000

int

Buzzer On Time 当选择闪烁时,以毫秒表示打开的持续时间。默认 = 1000。范围:100-5000

int

通信变量
变量名称 说明 数据类型
Protocol Communication Status

总结通信协议的状态。

0 = 无协议运行,协议驱动器可能未正确下载到 HMI 设备

1 = 协议已加载并启动,无通信错误

2 = 至少一个通信协议报告错误

int

只读

Protocol Error Message

具有错误源的通信错误。

For example: “[xxxx]”中“xxxx”是协议缩写,是错误源。

在多个错误源的情况下,多个缩写词出现。当无错误报表时,出现空白。

string

只读

Protocol Error Count 上一次复位以来的通信错误的数量。使用“复位协议错误计数”动作复位值,请参阅主手册中的“系统动作”

int

只读

数据库变量
变量名称 说明 数据类型
Database link error message

上一次检测的错误描述

string

只读

Database link status

0 = 未定义(未初始化)

1 = 连接(就绪)

2 = 未连接(不可用)

3 = 传输正在进行中

4 = 错误

int

只读

Database link error count 错误计数器。每次错误后会增加

int

只读

每个数据库变量是一个数组,其中索引选择数据库关联连接(范围 1-10)
变量仅在执行任一数据库连接器动作时更新

夏令时间变量
变量名称 说明 数据类型
Standard Offset 当标准时间设定时,偏移量以分钟计算,以 GMT 为准(例如:-8x60 = -480 分钟)

int

只读

Standard Week 标准时间开始的周(例如:第一 = 1)

int

只读

Standard Month 标准时间开始的月。范围:0-11。(例如:十一月 = 10)

int

只读

Standard Day 标准时间开始的星期(例如:星期天 = 0)

int

只读

Standard Hour 标准时间开始的小时(例如:02 = 2)

int

只读

Standard Minute 标准时间开始的分钟(例如:00 = 0)

int

只读

DST Offset 当 DLS 时间设定时,偏移量以分钟计算,以 GMT 为准。

int

只读

DST Week DLS 时间开始的周

int

只读

DST Month DLS 时间开始的月。范围:0-11

int

只读

DST Day DLS 时间开始的星期

int

只读

DST Hour DLS 时间开始的小时

int

只读

DST Minute DLS 时间开始的分钟

int

只读

所有变量均是只读的;它们不能用于更新系统时钟。

设备变量
变量名称 说明 数据类型
Available System Memory 剩余可用 RAM 存储,以字节为单位

uint64

只读

Backlight Time 从设备生产起,显示屏背光的激活小时数

unsignedInt

只读

Battery LED

启用/停用低电量 LED 指示器(可用时)

0 = 已禁用

1 = 已启用

Linux 平台上不可用(在 "HMI 设备地址"寻找您的设备平台)

int

Display Brightness

返回并调整明亮度。

当设为低光度 (0..3) 时,背光持续时间为 8 秒,使用户可以调整,然后关闭。

即使设为 0,背光仍然打开,背光时间计数器数值增加。范围:0-255

int

External Timeout

超过无操作时间后显示屏背光自动关闭。当用户接触屏幕时,背光自动打开

-1 =

关闭背光并停用触摸(关闭显示屏)。背光时间计数器停止。

需要 BSP v1.0.324 或更高版本。

-2 =

关闭背光但不停用触摸。如果按下触摸,事件未传达至应用程序,但屏幕保护程序退出且背光打开。

需要 BSP v1.0.324 或更高版本。

0 = 打开背光(打开显示屏)
1..n =

超时,以秒计算,用于关闭背光(屏幕保护程序计时器)

上,超时限值累计为分钟倍数(60, 120, 180 等)。

"HMI 设备地址"寻找您的设备平台。

int

Flash Free Space 内部闪存剩余空间

uint64

只读

Manufacturer Code 识别 HMI 的代号

short

只读

Server RAM Usage HMI 使用的当前 RAM 内存,以字节表示

uint64

只读

System Font List 系统字体列表

string

只读

System Mode

Runtime 操作状态

1 = 正在启动

2 = 配置模式

3 = 操作模式

4 = 重启

5 = 关闭

int

System UpTime 设备自生产起的系统通电时间(小时)

unsignedInt

只读

转储信息变量
变量名称 说明 数据类型
Dump Error Message 在执行转储操作期间,如果出现任何错误,则将返回错误消息

string

只读

Dump Archive Status

0 = 初始默认状态
1 = 操作已触发
2 = 操作成功完成
3 = 操作出错

int

只读

Dump Recipe Status

0 = 初始默认状态
1 = 操作已触发
2 = 操作成功完成
3 = 操作出错

int

只读

Dump Trend Status

0 = 初始默认状态
1 = 操作已触发
2 = 操作成功完成
3 = 操作出错

int

只读

Reset Recipe Status

0 = 初始默认状态
1 = 操作已触发
2 = 操作成功完成
3 = 操作出错

int

只读

Restore Recipe Status

0 = 初始默认状态
1 = 操作已触发
2 = 操作成功完成
3 = 操作出错

int

只读

网络变量
变量名称 说明 数据类型
Gateway

HMI 主网络界面的网关地址

string

只读

IP Address

HMI 主网络界面的 IP 地址

string

只读

Mac ID HMI 主网络界面的 MAC ID

string

只读

Network Adapter Parameters 可以用来读取或更新网络适配器参数的 JSON 字符串

string

Network Status

包含写入适配器参数内所需的所需的最后操作的结果。在每次写稿操作完成后更新。

  • 空字符串代表无错误
  • 最后错误说明

string

只读

Subnet Mask HMI 主网络界面的子网掩码

string

只读

PLC 变量
变量名称 说明 数据类型
Get CopyCodesysProject Action Status

提供复制Codesys项目动作的状态。

0 = 动作未调用

1 = 动作正在进行中

2 = 动作完成

3 = 动作已中止(缺少 CHK 文件)

4 = 动作已中止(缺少 PRJ 文件)

5 = 动作已中止(缺少 SDB 文件)

6 = 动作已中止(找到多个 CHK 文件)

7 = 动作已中止(找到多个 PRJ 文件)

8 = 动作已中止(找到多个 SDB 文件)

9 = 动作已中止(文件名不一致)

10 = 动作已中止(无法创建目录)

11 = 动作已中止(复制失败)

12 = 动作已中止(Codesys 模块不存在)

int

只读

PLC Status

提供内部 PLC 的状态。

0 = 运行模式

1 = 停止模式

2 = 从文件重新加载

3 = 重置热态

4 = 重置冷态

5 = 重置硬态

int

PLC 系统变量引用 CODESYS V2 内部 PLC

屏幕变量
变量名称 说明 数据类型
X Screen resolution 以像素显示横向屏幕大小

int

只读

Y Screen resolution

以像素显示纵向屏幕大小

int

只读

SD 卡变量
变量名称 说明 数据类型
SD Card FreeSpace

卡上的可用字节空间

uint64

只读

SD Card Name SD 卡名称

string

只读

SD Card Size 卡槽中卡的字节大小

uint64

只读

SD Card Status

0 = SD 卡已拔出

1 = SD 卡已插入

int

只读

服务器变量
变量名称 说明 数据类型
Page name 当前页面的名称

string

只读

Project Name 当前项目的名称

string

只读

Project load time 项目加载到 JMobile HMI Runtime 上的日期,采用系统日期格式(毫秒)

uint64

只读

Last operating mode start time

设备启动操作模式后经过的秒数

uint64

只读

所有变量均与服务器相关,而非 HMI Client

时间变量
变量名称 说明 数据类型
Day Of Month 范围:1-31

int

Day Of Week

范围:0 = 星期日,依此类推,6 = 星期六

int

Hour 范围:0-23

int

Minute 范围:0-59

int

Month

范围:1-12

int

Second

范围:0-59

int

System Time 与 UTC 时间相同。也可设为此变量的日期/时间 unsignedInt
Year 当前年份 int

以 UTC 格式表示的系统时间

USB 驱动器变量
变量名称 说明 数据类型
USB Drive FreeSpace 可用字节空间

uint64

只读

USB Drive Name

USB 设备的名称

string

只读

USB Drive Size USB 端口插入的设备的字节大小

uint64

只读

USB Drive Status

0 = USB 驱动器已拔出

1 = USB 驱动器已插入

int

只读

版本变量
变量名称 说明 数据类型
Main OS version 主操作系统版本

string

只读

Runtime version

Runtime 版本

string

只读

Project name 项目名称

string

只读

Project version 与运行版本不一致

string

 

Project GUID 项目 GUID(唯一标识符)

string

只读

虚拟通信开关变量
变量名称 说明 数据类型
VCS status

提供 VCS 服务的状态。

0 = 已启用服务

1 = 客户端以交错模式连接

2 = 客户端以独占模式连接

3 = 已禁用服务(默认)

unsignedByte

只读

VCS disable

提供 VCS 服务的手动覆盖。

0 = 已启用 VCS 服务

1 = 已禁用 VCS 服务(默认)

boolean

VCS port 通过 VCS 服务提供 HMI 上的当前侦听 TCP 端口 unsignedShort

 

数据类型

每个系统变量具有特定的数据类型,如上表中所述。

下表显示用于系统变量的任何数据类型详细信息。

数据类型 内存空间 限制
short 16 位数据 -32768 ...32767
int 32 位数据 -2.1e9 ...2.1e9
unsignedByte 8 位数据 0 ...255
unsignedShort 16 位数据 0 ...65535
unsignedInt 32 位数据 0 ...4.2e9
uint64 64 位数据 0 ...1.8e19
string 元素数组,包含通过所选编码定义的字符代码

Arraysize

如果是字符串标签,此属性代表字符串标签中字节的最大数量。

注:如果在标签编辑器中将编码属性设为 UTF-8 或 Latin1,则字节数将与字符串字符数对应。
如果编码属性设为 UCS-2BE、UCS-2LE、UTF-16BE 或 UTF-16LE,则一个字符需要 2 个字节。

转换

应用于标签的转换。

根据选择的数据类型,允许列表将显示一个或多个转换类型。

说明
Inv bits

inv:对标签的所有位取反。

示例:
1001 → 0110(二进制格式)
9 → 6(十进制格式)

Negate

neg:设置标签值求反。

示例:
25.36 → -25.36

AB -> BA

swapnibbles:用一个字节交换半字节。

示例:
15D4 → 514D(十六进制格式)
5588 → 20813(十进制格式)

ABCD -> CDAB

swap2:用一个字来交换字节。

示例:
9ACC → CC9A(十六进制格式)
39628 → 52378(十进制格式)

ABCDEFGH -> GHEFCDAB

swap4:以双字交换字节。

示例:
32FCFF54 → 54FFFC32(十六进制格式)
855441236 → 1426062386(十进制格式)

ABC...NOP -> OPM...DAB

swap8:用长字交换字节。

示例:
142.366 → -893553517.588905(十进制格式)
0 10000000110 0001110010111011011001000101101000011100101011000001

1 10000011100 1010101000010100010110110110110010110110000100111101
(二进制格式)

BCD

bcd:在两个半字节中分隔字节,将它们读为十进制(从0到9)

示例:
23 → 17(十进制格式)
0001 0111 = 23
0001 = 1(第一个半字节)
0111 = 7(第二个半字节)

选择转换并点击+。所选项目将被添加到已配置列表中。

如果配置了多个转换,将按顺序应用这些转换(从已配置列表自上而下)。

使用箭头按钮可对配置的转换进行排序。